home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / viet1p6.zip / VMORE.DOC < prev    next >
Text File  |  1991-10-02  |  5KB  |  122 lines
  1. \V
  2.                               VMORE
  3.  
  4.           Copyright 1991 by Ho`a G. Nguye^~n and Nhu+-Nga` T. DDo^~
  5.                P.O\. Box 3834, La Mesa, CA 91944-3834
  6.                     _________________________
  7.  
  8.      VMORE is a file-reading utility like Unix' "more", but takes 
  9. pseudo-Vietnamese as input.    Several  input styles can be used.  
  10. Executing VMORE without any parameter will display a help message 
  11. to guide you through it.  The normal usage of VMORE is:  
  12.  
  13.                vmore [-options] sourcefile [destination file]
  14.  
  15.      If you only supply one parameter after VMORE, for example
  16.  
  17.                vmore xxx
  18.  
  19. then VMORE  takes the file xxx,  which  is assumed  to  be in the 
  20. format used  on Viet-net and the newsgroup soc.culture\.vietnamese 
  21. (SCV), and displays it page-by-page, in "true"  Vietnamese, using 
  22. the VIE^'T font SCRFONT.   You can use the space key to move ahead, 
  23. "b" to move back, and "q" to quit.  
  24.  
  25.      If a destination file name is supplied,  the output is  also 
  26. stored there\.
  27.  
  28.      The options are: (options can be combined, for example, -en)
  29.      
  30.      p,P  :   reverse   conversion   from  a  VIE^'T  file  to  the 
  31.               SCV/Viet-net format, for posting.
  32.  
  33.      e,E  :   unambiguous  conversion from a VIE^'T file to a 7-bit 
  34.               format for  electronic mailing.
  35.  
  36.      m,M  :   opposite of  e\.   Reconvert from the unambiguous 7-
  37.               bit format to a VIE^'T file\.
  38.  
  39.      n,N  :   no display (just   convert  and  store--\destination 
  40.               file is required).
  41.  
  42.      NOTE:   while Vietnamese text is being displayed (in default 
  43. or -m mode), F2 and F3 can be used to change the display color to 
  44. suit your taste\.   The color chosen will be remembered for future 
  45. use\.
  46.  
  47.      The necessity for the "e"  and "m" options resulted from the 
  48. fact that   the SCV/Viet-net format is ambiguous.    For example, 
  49. "to\^."  can be interpreted  two ways.     VMORE  uses  a group of 
  50. heuristics to  reduce these ambiguities as much as possible,  but 
  51. they cannot be totally eliminated.   For example, to tell whether 
  52. the dot is a period or da^'u na(.ng, VMORE uses this heuristic:
  53.  
  54.      *  It scans ahead for the next printing character,  skipping 
  55. over spaces and clause-ending marks such as ),},],>.
  56.  
  57.      *   If  the  next character  is  a  lowercase,  the  dot  is 
  58. interpreted as a da^'u na(.ng.
  59.  
  60.      * If   the next character  is  uppercase,  we have   another 
  61. problem.     For example:    in  "cu\.  Ca\`ng",   the dot  can  be 
  62. interpreted both  ways.    Here   VMORE uses a typing rule we all 
  63. (hopefully) have learned in  our high-school typing class:  put 2 
  64. spaces  after a sentence-ending punctuation mark!   Thus if there 
  65. are more than 1 space between the dot and the  uppercase  letter, 
  66. the dot is interpreted as a period, else it's a da^'u na(.ng.
  67.  
  68.      *  There are a hosts of other rules just to handle  the dot, 
  69. including the  cases when the next character is a digit,  certain 
  70. punctuation marks, or there are line-feeds in between, etc.   One 
  71. case that VMORE still  doesn't deal with  very effectively is the 
  72. presence of ellipses (...  or ....).  For  now,  we will have  to 
  73. settle with placing a space before ellipses.
  74.  
  75.      This ambiguity points to the  need for an  umbiguous  coding 
  76. scheme for data interchange\.   The  scheme we  have adopted  here 
  77. (for the  m and  e  options)  is  the  TriChlor/Viet-Std  quoted-
  78. readable  7-bit format (thanks  to  the TriChlor  group for their 
  79. help in this interface).  Thus not only is unambiguous electronic 
  80. mail available between PC users,  it is also available between PC 
  81. and Unix  domains  (with TriChlor's Unix  programs at  the  other 
  82. end).
  83.  
  84.      (For those curious souls,  with the -e option, VMORE convert 
  85. the file to the \\V mode and ad\ded a \\V to the front of the  file; 
  86. with the -m option, VMORE can convert both the \\M and the \\V-type 
  87. data to VIE^'T format.)
  88.  
  89.      Helpful  hint for composing messages for posting using VIE^'T:  
  90. since there is  an  expansion from  VIE^'T  format  to SCV/Viet-net  
  91. format,   you  should  set  the right   margin  at  60 or   less,  
  92. and  set justification to NO,  for a nice output after conversion 
  93. by VMORE\.
  94.  
  95.  
  96. CONVENTIONS:
  97.  
  98.      In converting SCV/Viet-net messages to VIE^'T,   VMORE accepts 
  99. the following characters:
  100.  
  101.              Character              Interpreted as
  102.  
  103.                ' /                      da^'u sa('c
  104.                ` \\                      da^'u huye^`n
  105.                ?                        da^'u ho?i
  106.                ~                        da^'u nga~
  107.                .                        da^'u na(.ng
  108.                ( <                      da^'u a(
  109.                ^                        da^'u a^
  110.                + *                      da^'u o+
  111.                d\d -\d                    dd
  112.  
  113.      Although the  quotation  mark (") is   sometimes  used    by 
  114. SCV/Viet-net posters as "da^'u o+",  its use is discouraged since it 
  115. is also commonly used in its proper role--as quotation marks--and 
  116. dual use  creates  ambiguities that are  unresolvable (since it's 
  117. not a sentence ending mark).
  118.  
  119.      In  reverse translation  (-p option),  VMORE uses the  first 
  120. character of each group in the left column above\.
  121.  
  122.